home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / man / cmds.fmt / ggraph.man < prev    next >
Encoding:
Text File  |  1990-01-22  |  9.8 KB  |  265 lines
  1.  
  2.  
  3.  
  4. GGRAPH                    User Commands                    GGRAPH
  5.  
  6.  
  7.  
  8. NNAAMMEE
  9.      ggraph
  10.  
  11. SSYYNNOOPPSSIISS
  12.      ggggrraapphh [[iinnppuutt ffiillee [[oouuttppuutt ffiillee]]]]
  13.  
  14.           iinnppuutt ffiillee  is the _g_g_r_a_p_h input file.  If omitted,
  15.                       stdin is read.
  16.           oouuttppuutt ffiillee is the _g_g_r_a_p_h output file.  If omitted, the
  17.                       file name is given in the _d_r_a command
  18.                       described below.  This is the preferred
  19.                       usage.
  20. DDEESSCCRRIIPPTTIIOONN
  21.      _G_g_r_a_p_h is a program which will take points and produce grem-
  22.      lin files which may be displayed by _g_r_e_m_l_i_n or included in
  23.      _d_i_t_r_o_f_f documents.  _G_g_r_a_p_h takes as input _g_g_r_a_p_h files and
  24.      produces SUN gremlin files.  The minimum amount of informa-
  25.      tion needed is a set of X and Y coordinates.  _G_g_r_a_p_h will
  26.      automatically scale the points to fit the graph area.
  27.      Currently, four types of graphs are supported: linear
  28.      (including curves), log graphs, histograms and bar graphs.
  29.      In addition all of the line types supported by _g_r_e_m_l_i_n are
  30.      supported by _g_g_r_a_p_h.  _G_g_r_a_p_h is currently under development
  31.      and therefore new features will be added from time to time.
  32.      In addition backwards compatibility is _n_o_t guaranteed at
  33.      this time.
  34.      A _g_g_r_a_p_h input file is an ASCII file containing _g_g_r_a_p_h com-
  35.      mands and data.  Each command is on a separate line.  Blank
  36.      lines may be inserted as separators with no problem.  The
  37.      coordinates for the points of the graph are read as floats.
  38.      Whitespace may be used arbitrarily to seperate different
  39.      elements of a line. Lastly, a semicolon is a comment charac-
  40.      ter causing the rest of the line to be ignored.
  41.  
  42.      The following is a list of the _g_g_r_a_p_h commands:
  43.  
  44.      _C_o_m_m_a_n_d       _A_r_g_u_m_e_n_t_s            _M_e_a_n_i_n_g
  45.       com   <rest of line>              Comment
  46.       cro   on|off                      Turn on X/Y cross hair
  47.       crx   on|off                      Turn on X axis cross hair
  48.       cry   on|off                      Turn on Y axis cross hair
  49.       dae                               Data set end
  50.       das   <string>                    Data start
  51.       dra   <output file name>          Draw graph
  52.       fir   on|off                      First tick mark both axises on/off
  53.       fra   on|off                      Frame on or off
  54.       frt   <size #>                    Frame thickness
  55.       gti   <string>                    Graph title
  56.       gtp   <X pos> <Y pos>             Graph title position
  57.       lcu   <line name> <curve type>    Curve type
  58.       leg   on|off                      Turn on legend
  59.       leb   on|off                      Draw box around legend
  60.  
  61.  
  62.  
  63. Sprite v1.0               1 March 1986                          1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. GGRAPH                    User Commands                    GGRAPH
  71.  
  72.  
  73.  
  74.       les   on/off                      Legend position - right side/bottom
  75.       lla   <line name> on|off          Line label on/off
  76.       llf   <font #>                    Line label font
  77.       lls   <size #>                    Line label size
  78.       llp   <line name> <X pos> <Y pos> Line label position
  79.       lof   <line name> on|off          Line on/off
  80.       log   on|off                      Log-log graph
  81.       lox   on|off                      X coordinates log
  82.       loy   on|off                      Y coordinates log
  83.       lsy   <line name> <symbol #>      Line symbol
  84.       lth   <size #>                    Line thickness
  85.       lty   <line name> <type #>        Line type
  86.       qui                               Quit
  87.       rea   <file name>                 Read a command file
  88.       sla   <line name> <string>        Line label string
  89.       sle   <line name> <label>         Set legend line label for a line
  90.       slf   <font #>                    Set legend title font
  91.       slh   <label>                     Set legend string
  92.       sls   <size #>                    Set legend title character size
  93.       ssw   on|off                      Symbols on or off
  94.       sun   <value>                     Set graph units
  95.       sxt   <min X value> <max X value> <number of ticks>
  96.                                         Set X axis scaling
  97.       syt   <min Y value> <max Y value> <number of ticks>
  98.                                         Set Y axis scaling
  99.       syz   <size #>                    Set symbol size
  100.       tif   on|off                      Graph title on/off
  101.       typ   <type #>                    Type of graph
  102.       ver   on|off                      Y label vertical
  103.       tft   <font #>                    Title font
  104.       tis   <size #>                    Title text size
  105.       xax   on|off|top|bottom|both      X axis on/off and position
  106.       yax   on|off|left|right|both      Y axis on/off and position
  107.       xfi   on|off                      First tick mark X axis on/off
  108.       yfi   on|off                      First tick mark Y axis on/off
  109.       xft   <font #>                    X label font
  110.       yft   <font #>                    Y label font
  111.       xle   <length>                    X axis length in units
  112.       yle   <length>                    Y axis length in units
  113.       xgr   on|off                      X grid on/off
  114.       ygr   on|off                      Y grid on/off
  115.       xgt   <grid #>                    X grid type
  116.       ygt   <grid #>                    Y grid type
  117.       xla   <string>                    X label
  118.       yla   <string>                    Y label
  119.       xpr   <#> <#>                     Precision for X tick labels
  120.       ypr   <#> <#>                     Precision for Y tick labels
  121.       xst   <# of tick> [<delta> [<starting tick> [<dev org>]]]
  122.                                         Set X scaling (obsolete)
  123.       yst   <# of tick> [<delta> [<starting tick> [<dev org>]]]
  124.                                         Set Y scaling (obsolete)
  125.       xtf   <font #>                    Set X tick label font
  126.  
  127.  
  128.  
  129. Sprite v1.0               1 March 1986                          2
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. GGRAPH                    User Commands                    GGRAPH
  137.  
  138.  
  139.  
  140.       ytf   <font #>                    Set Y tick label font
  141.       xtp   <X pos> <Y pos>             X label position
  142.       ytp   <X pos> <Y pos>             Y label position
  143.       xti   on|off|in|out|both          X ticks on/off
  144.       yti   on|off|in|out|both          Y ticks on/off
  145.       xtl   on|off                      X label on/off
  146.       ytl   on|off                      Y label on/off
  147.       xts   <size #>                    X label text size
  148.       yts   <size #>                    Y label text size
  149.       xtz   <size #>                    Set X tick label character size
  150.       ytz   <size #>                    Set Y tick label character size
  151.  
  152.      There are seven line types supported by _g_g_r_a_p_h and _g_r_e_m_l_i_n.
  153.      They are:
  154.           BRUSH_INVISIBLE  0
  155.           BRUSH_DOT        1
  156.           BRUSH_ALT        2
  157.           BRUSH_THICK      3
  158.           BRUSH_DASH       4
  159.           BRUSH_THIN       5
  160.           BRUSH_NORMAL     6
  161.  
  162.      There are four fonts defined in _g_g_r_a_p_h and _g_r_e_m_l_i_n.  These
  163.      may be changed arbitrarily with _g_r_n when the graph is
  164.      printed.  The fonts are:
  165.           ROMAN       1
  166.           ITALICS     2
  167.           BOLD        3
  168.           SPECIAL     4
  169.  
  170.      There are four font sizes supported by _g_g_r_a_p_h and _g_r_e_m_l_i_n.
  171.      See the _g_r_e_m_l_i_n manual for their comparative sizes.
  172.           SMALL       1
  173.           MEDIUM      2
  174.           LARGE       3
  175.           EXLARGE     4
  176.  
  177.      There are currently eleven symbols defined.  They are:
  178.           NOSYMBOL        0
  179.           BOX             1
  180.           RING            2
  181.           CROSS           3
  182.           STAR            4
  183.           TRIANGLE        5
  184.           UTRIANGLE       6
  185.           CROSSBOX        7
  186.           STARBOX         8
  187.           DIAMOND         9
  188.           CROSSDIAMOND   10
  189.  
  190. FFIILLEESS
  191.      None
  192.  
  193.  
  194.  
  195. Sprite v1.0               1 March 1986                          3
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. GGRAPH                    User Commands                    GGRAPH
  203.  
  204.  
  205.  
  206. AAUUTTHHOORR
  207.      Ed Hunter (edh@Sun.COM)
  208. SSEEEE AALLSSOO
  209.      gremlin (l), grn (l), ditroff (l), pic (l)
  210. BBUUGGSS
  211.      N/A
  212. EEXXAAMMPPLLEE
  213.      The following is a simple _g_g_r_a_p_h input file:
  214.  
  215.           com Sample ggraph input file
  216.           xla Repetition count                   ;set the X axis label
  217.           yla Sec                                ;set the Y axis label
  218.           gti Total time by packet count         ;set the graph title
  219.           das foo                                ;define a data set foo
  220.           500 4                                  ;data points X, Y
  221.           1000 8
  222.           5000 53
  223.           9000 82
  224.           dae                                   ;end the dataset
  225.           das bar                               ;start another dataset bar
  226.           500 6
  227.           1000 12
  228.           5000 59
  229.           9000 105
  230.           dae                                   ;end the dataset
  231.           syz 5                                 ;set symbol size to 4
  232.           dra graph1                            ;draw a graph in file graph1
  233.           sxt 0.0 10000.0 10                    ;set X axis scaling
  234.           syt 0.0 200.0 10                      ;set Y axis scaling
  235.           xgr off                               ;turn off X grid
  236.           ygr off                               ;turn off Y grid
  237.           lof foo off                           ;turn off line foo
  238.           fra off                               ;turn the frame off
  239.           dra graph2                            ;draw another graph
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261. Sprite v1.0               1 March 1986                          4
  262.  
  263.  
  264.  
  265.